AttestationException

Provides additional details on why an attestation attempt failed, indicating which platform was being attested. Although many reasons exist, why an attestation may fail, these can be put into two categories:

  • Content e.g. version, app name, challenge, or key mismatch

  • Certificate e.g. chain rooted in an untrusted certificate, revocation, validity period

If more specific details about why the attestation failed are available, message and/or cause will be set. Especially when acting upon Errors propagating from a failed Android attestation, the type of the cause and error codes contained within will provide insights.

Inheritors

Types

Link copied to clipboard

Indicates a problem verifying the certificate chain the attestation statement is built upon. This can either be just a borked certificate chain (i.e. just a wrong certificate somewhere in the chain), or the chain not being rooted in a valid trust anchor. Most probably, however, a legitimate app on a trusted OS will simply have fallen victim to the system clock being too far ahead. This heavily depends on the OS a device was originally shipped with, (or just Samsung being Samsung and being unable to correctly encode a timestamp conforming to ASN.1)

Link copied to clipboard
class Configuration(val platform: Platform, message: String? = null, cause: Throwable? = null) : AttestationException

Thrown on instantiation, for illegal configurations (e.g. no apps configured)

Link copied to clipboard
open class Content(val platform: Platform, message: String? = null, cause: Throwable? = null) : AttestationException

Indicates that some value (key to be attests, bundle identifier or package name, team identified or signer certificate, etc.) failed to verify This usually means that either the client's OS or the app was compromised/modified.

Properties

Link copied to clipboard
open val cause: Throwable?
Link copied to clipboard
open val message: String?
Link copied to clipboard

Functions

Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
open override fun toString(): String